Return Values From The Web-Activator

SoftwareShield Web-Activator > Return Values From The Web-Activator

## Return Values From The Web-Activator

The possible responses you get from the Web-Activator fall into two categories.

1. A successful response with an Activation Code

2. A failed response.

All responses will be formatted according to the rules of Web-Activator Communication. Basically, the Activation Code (and any demo edition messages) will appear for every instance for a specific placeholder in an HTML template. The following are the possible successful and unsuccessful responses you may get back:

- If successful, an Activation Code will be in the response. If you use the default settings, this response will be formed exactly like the following message.
  <softshop>
  1234-5678-90AB-CDEF
  </softshop>

- If you receive a successful response, while using the demo edition of SoftwareShield, the activation code will be marked by a message indicating that it was done using a license that was created using a demo edition. You should only get this type of message when you are evaluating the SoftwareShield demo edition.
  <softshop>
  THIS ACTIVATION CODE WAS GENERATED WITH A DEMO VERSION OF THE SOFTWARESHIELD LICENSEING SYSTEM.
  1234-5678-90AB-CDEF
  THIS ACTIVATION CODE WAS GENERATED WITH A DEMO VERSION OF THE SOFTWARESHIELD LICENSEING SYSTEM.
  </softshop>

- An error message response. You may have assembled the URL correctly, however, some error occurred. Some possible errors are the Authorization Request Code does not correspond to the license you indicated, the license you indicated was not found on the server in the correct location, the parameter you provided incorrect or out of range, etc. Possible responses include, but are not limited to (note, for the default settings, all the following strings would be wrapped with the "<softshop></softshop>" tags) :

  Please tell your vendor: No parameters were passed to the Activation Code Generator.
  Please tell your vendor: The parameter identifier \"%s\" was not found in the query.
  Please tell your vendor: The license project \"%s\" was not found on the license server.
  Please tell your vendor: The license project specified \"%s\" does not have the correct license project extension
  Please tell your vendor: The license project specified \"%s\" does not have the correct license project extension
  Please tell your vendor: The license project specified \"%s\" does not have the correct license project extension
  Please tell your vendor: The Authorization Request Code supplied \"%s\" is not the correct format.
  Please tell your vendor: The Authorization Request Code supplied \"%s\" does not represent a valid Authorization Request ID in the license \"%s\".

- An error message generated when you try to use the Web-Activator with a licensed edition of SoftwareShield that does not include it. Only the Internet Edition of SoftwareShield comes with the Web-Activator. You would only get this message if you are trying to illegally use SoftwareShield components you have not paid for. For information about upgrading your version of SoftwareShield, please contact us.
  <SOFTSHOP>
  THIS IS AN ERROR MESSAGE. YOUR SOFTWARE VENDOR HAS PURCHASED THE <whatever you own> VERSION ONLY OF SOFTWARESHIELD. THE WEB-ACTIVATOR DOES NOT OPERATE IN THE <whatever you own> VERSION. PLEASE TELL YOUR SOFTWARE VENDOR TO CONTACT WWW.SOFTWARESHIELD.COM TO INQUIRE ABOUT UPGRADING.
  </SOFTSHOP>

- No response. You have assembled a completely malformed URI or have not called the application using and http GET request.

Note: The SoftwareShield Web-Activator only comes with the Internet and Server Editions of the SoftwareShield System.